docs: update runner and architecture compatibility by Mossaka · Pull Request #992 · github/gh-aw-firewall

Mossaka · 2026-02-21T01:13:04Z

Summary

Update docs/compatibility.md with the full runner support matrix based on extensive testing.

Changes

Add comprehensive GitHub Actions runner table with all tested configurations
Upgrade ARM64 (ubuntu-24.04-arm) from "May Work" to "Fully Supported"
Add macOS and Windows runners as explicitly not supported with reasons
Add "Why macOS runners are not supported" section explaining the nested virtualization limitation

🤖 Generated with Claude Code

Update the compatibility matrix with tested runner configurations: - ubuntu-24.04-arm (ARM64) now fully supported - macOS runners explicitly marked as not supported with explanation - Windows runners marked as not supported - ARM64 architecture upgraded from "May Work" to "Fully Supported" Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Copilot

Pull request overview

This PR updates the compatibility documentation (docs/compatibility.md) to provide a comprehensive runner support matrix for GitHub Actions. The main goal is to clarify which GitHub Actions runners are supported by the Agentic Workflow Firewall (AWF).

Changes:

Converted the GitHub Actions runner section from a simple list to a detailed table showing runner name, architecture, support status, and notes
Upgraded ARM64 support status (ubuntu-24.04-arm) from "⚠️ May Work" to "✅ Fully Supported"
Added explicit "Not Supported" entries for macOS and Windows runners with technical justifications
Added a new section explaining why macOS runners cannot support AWF due to nested virtualization limitations

Comments suppressed due to low confidence (1)

docs/compatibility.md:42

The claim that ubuntu-24.04-arm is "Fully Supported" appears inconsistent with the CI configuration. After searching all workflow files in .github/workflows/, no workflows are currently configured to run on ubuntu-24.04-arm runners. The codebase only builds multi-architecture container images (amd64 and arm64) in the release workflow, but does not actually test AWF functionality on ARM64 runners.

To make this claim accurate, either:

Add CI workflows that test on ubuntu-24.04-arm runners (e.g., update test-action.yml, test-coverage.yml, or smoke tests to include an ARM64 matrix entry), or
Downgrade the status to "⚠️ May Work" with a note like "Multi-arch containers are built but not actively tested on ARM runners" until actual CI testing is in place.

The current "Fully Supported" designation suggests active CI testing and validation, which could be misleading to users.

| `ubuntu-24.04-arm` | arm64 | ✅ Fully Supported | Linux ARM64. Docker, AWF, and MCP Gateway all work. |

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-21T01:16:22Z

docs/compatibility.md

 |--------------|--------|-------|
 | x86_64 (amd64) | ✅ Fully Supported | Primary development platform |
-| arm64 (aarch64) | ⚠️ May Work | Not actively tested |
+| arm64 (aarch64) | ✅ Fully Supported | Tested on `ubuntu-24.04-arm` GitHub Actions runners |


The note "Tested on ubuntu-24.04-arm GitHub Actions runners" is not supported by evidence in the codebase. No CI workflows are configured to run on ARM runners, and there's no test output or workflow history included that demonstrates successful ARM64 testing.

Consider revising to accurately reflect the testing status, such as: "Multi-arch containers built; manual testing required" or provide evidence of the testing (e.g., workflow runs, test results) if it was done outside the repository's CI system.

This issue also appears on line 42 of the same file.

github-actions · 2026-02-21T01:16:45Z

Build Test: Deno Results

Project	Tests	Status
oak	1/1	✅ PASS
std	1/1	✅ PASS

Overall: ✅ PASS

Generated by Build Test Deno for issue #992

github-actions · 2026-02-21T01:16:56Z

Node.js Build Test Results

Project	Install	Tests	Status
clsx	✅	✅	PASS
execa	✅	✅	PASS
p-limit	✅	✅	PASS

Overall: PASS 🎉

Generated by Build Test Node.js for issue #992

github-actions · 2026-02-21T01:17:03Z

Rust Build Test Results

Project	Build	Tests	Status
fd	✅	1/1	PASS
zoxide	✅	1/1	PASS

Overall: PASS ✅

Generated by Build Test Rust for issue #992

github-actions · 2026-02-21T01:17:05Z

Smoke Test Results — Claude (run #22247387859)

✅ GitHub MCP: #975 chore: remove _codeql_detected_source_root, #977 fix: add iptables bypass for container self-traffic
✅ Playwright: github.com title contains "GitHub"
✅ File write: /tmp/gh-aw/agent/smoke-test-claude-22247387859.txt created
✅ Bash verify: file read back successfully

Overall: PASS

💥 [THE END] — Illustrated by Smoke Claude for issue #992

github-actions · 2026-02-21T01:17:15Z

Bun Build Test Results

Project	Install	Tests	Status
elysia	✅	1/1	PASS
hono	✅	1/1	PASS

Overall: PASS 🎉

Bun v1.3.9 — ran on workflow #22247387896

Generated by Build Test Bun for issue #992

github-actions · 2026-02-21T01:22:14Z

Build Test: Bun Results ✅

Project	Install	Tests	Status
elysia	✅	1/1	PASS
hono	✅	1/1	PASS

Overall: PASS

Bun version: 1.3.9

Generated by Build Test Bun for issue #992

github-actions · 2026-02-21T01:22:32Z

Smoke Test Results — @Mossaka

Test	Result
GitHub MCP (last 2 PRs: #984, #981)	✅
Playwright (`github.com` title check)	✅
File write + bash verify	✅

Overall: PASS

📰 BREAKING: Report filed by Smoke Copilot for issue #992

github-actions · 2026-02-21T01:22:47Z

Build Test: Node.js Results

Project	Install	Tests	Status
clsx	✅	✅	PASS
execa	✅	✅	PASS
p-limit	✅	✅	PASS

Overall: ✅ PASS

Generated by Build Test Node.js for issue #992

github-actions · 2026-02-21T01:22:51Z

Deno Build Test Results

Project	Tests	Status
oak	1/1	✅ PASS
std	1/1	✅ PASS

Overall: ✅ PASS

Generated by Build Test Deno for issue #992

github-actions · 2026-02-21T01:23:02Z

🔮 The oracle has spoken through Smoke Codex for issue #992

github-actions · 2026-02-21T01:23:03Z

Go Build Test Results

Project	Download	Tests	Status
color	✅	PASS	✅ PASS
env	✅	PASS	✅ PASS
uuid	✅	PASS	✅ PASS

Overall: ✅ PASS

Generated by Build Test Go for issue #992

github-actions · 2026-02-21T01:23:06Z

.NET Build Test Results

Project	Restore	Build	Run	Status
hello-world	✅	✅	✅	PASS
json-parse	✅	✅	✅	PASS

Overall: PASS

Run output

hello-world:

Hello, World!
```

**json-parse:**
```
{
  "Name": "AWF Test",
  "Version": 1,
  "Success": true
}
Name: AWF Test, Success: True

Generated by Build Test .NET for issue #992

github-actions · 2026-02-21T01:23:15Z

Smoke Test Results (Claude claude-sonnet-4-6)

✅ GitHub MCP: #984 fix: prevent agent from accessing host git credentials, #975 chore: remove _codeql_detected_source-root
✅ Playwright: github.com title contains "GitHub"
✅ File write: /tmp/gh-aw/agent/smoke-test-claude-22247480589.txt created
✅ Bash verify: file contents confirmed

Overall: PASS

💥 [THE END] — Illustrated by Smoke Claude for issue #992

github-actions · 2026-02-21T01:23:19Z

Java Build Test Results

Project	Compile	Tests	Status
gson	✅	1/1	PASS
caffeine	✅	1/1	PASS

Overall: ✅ PASS

Generated by Build Test Java for issue #992

github-actions · 2026-02-21T01:23:20Z

🦀 Rust Build Test Results

Project	Build	Tests	Status
fd	✅	1/1	PASS
zoxide	✅	1/1	PASS

Overall: ✅ PASS

Generated by Build Test Rust for issue #992

github-actions · 2026-02-21T01:23:20Z

C++ Build Test Results

Project	CMake	Build	Status
fmt	✅	✅	PASS
json	✅	✅	PASS

Overall: PASS

Generated by Build Test C++ for issue #992

Copilot AI review requested due to automatic review settings February 21, 2026 01:13

Copilot started reviewing on behalf of Mossaka February 21, 2026 01:13 View session

Copilot AI reviewed Feb 21, 2026

View reviewed changes

github-actions bot added the build-test-deno label Feb 21, 2026

github-actions bot added the build-test-node label Feb 21, 2026

github-actions bot added the build-test-rust label Feb 21, 2026

github-actions bot added the smoke-claude label Feb 21, 2026

github-actions bot added the build-test-bun label Feb 21, 2026

github-actions bot mentioned this pull request Feb 21, 2026

[agentics] No-Op Runs #769

Open

Mossaka force-pushed the docs/runner-compatibility branch from c97443f to 74de5ef Compare February 21, 2026 01:18

github-actions bot added the smoke-copilot label Feb 21, 2026

github-actions bot added the build-test-go label Feb 21, 2026

github-actions bot added the build-test-dotnet label Feb 21, 2026

github-actions bot added the build-test-java label Feb 21, 2026

github-actions bot added the build-test-cpp label Feb 21, 2026

Comments

Conversation

Mossaka commented Feb 21, 2026

Summary

Changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 21, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Feb 21, 2026

Build Test: Deno Results

Uh oh!

github-actions bot commented Feb 21, 2026

Node.js Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

Rust Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

Uh oh!

github-actions bot commented Feb 21, 2026

Bun Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

Build Test: Bun Results ✅

Uh oh!

github-actions bot commented Feb 21, 2026

Uh oh!

github-actions bot commented Feb 21, 2026

Build Test: Node.js Results

Uh oh!

github-actions bot commented Feb 21, 2026

Deno Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

Uh oh!

github-actions bot commented Feb 21, 2026

Go Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

.NET Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

Uh oh!

github-actions bot commented Feb 21, 2026

Java Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

🦀 Rust Build Test Results

Uh oh!

github-actions bot commented Feb 21, 2026

C++ Build Test Results

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant